FIRST Tech Challenge Logo

QuickStart

Install VRS and Set Up Autonomous and TeleOp OpModes

The Ultimate Goal VRS is the ideal Teaching Simulation.  The field is wide open and kids love to shot rings at the targets .   IF you are a FIRST Time Coder– then start with these VRS Challenges lessons  1-6 UG Lessons   3-4 hours

 

We are going to create an autonomous OpMode, but the same concept applies for teleOp.

What is an OpMode?

An OpMode is analogous to a Java class. It is a file that contains all your code and methods. There is a runOpMode method which contains the blocks that run when you press the run button

TeleOp vs Autonomous

This tutorial starts off with Autonomous programming, then moves on to TeleOp. Autonomous is when the robot navigates independently, without driver control. TeleOp is when the robot drives based on gamepad input.

How do I create an OpMode?

When you click on autonomous or teleOp from the main menu, you will be transported into the interface with an opMode auto-generated. The code in the opMode is in the blocks editor on the left. To save your OpMode, click the “Save As” button above the blocks editor. Enter the name of your OpMode, making sure you pick a clear, descriptive name. To load a saved opMode, click the Load Program button to the right of the Save As.

  • You’ll see some auto-generated code in the blocks editor. This is mostly just the declarations that are needed to run the code properly. The meaning of each of this blocks can be found

How does code in VRS work?

VRS supports making methods, and variables just like FTC blocks. Such advanced concepts will be addressed later. For now, look at the auto-generated block of code and notice the blue if-do block. Inside it are some orange blocks that set motor power. All of your code will go inside this if block, as it is what the simulator runs.

Looking at the default code

The default code shows some of the most critical blocks for the simulator. Lets look through what each of them mean:

1. Set Power

This block is used to make the motors move. Since this motor has four independently driven wheels, there are four motors, labeled to their respective positions. 1 is the maximum power you can give to a motor, and you can input any value from 0 to 1 to control its speed(negative values drive it in reverse). To find this block in the sidebar, click Actuator>DcMotor>setPower. Remember that VRS simulates a mecanum wheel robot, so you can program it to move in any direction by varying the powers.

2. Telemetry


Telemetry is used to print text to the telemetry log above the field. The key is the label for the data, and the text is the value that the label represents. You can add any text here, and every time telemetry.update() is called, it will print that to the log.see also 

3. Sleep

 

Sleep essentially halts the programs for the given number of milliseconds. This however, does not mean that the robot stops moving. It just means that the program will wait for the given amount of time before moving on the next line of code. At the very end of your autonomous mode, it is good to add a 30,000 millisecond sleep statement, so that your robot does not do anything unpredictable until the autonomous period ends.

We will come back to blocks in Step 5. 

Assuming that we still have the auto-generated code, let’s take a look at how to run programs in VRS. By default, VRS will run the code contained in the purple “runOpMode” block. Unless you call other methods there, they will not run. 

You can select from 3 different camera angles. See this document for instructions.

Run

When running an opMode, you first initialize the program, then run it. Initialization is when basic reset code runs once, and running is when the movement actually happens. It is no different than a real FTC robot.

Above the telemetry console, you will see an Initialize Program button. 

Click it, and you will see two buttons appear, one saying  Start program and one saying Stop Program. Press start program to run. Your robot should move forward.

At the same time, the timer on the field will start running. Your code should auto-cutoff when the timer ends.

Alright, now that we are familiar with the interface, let’s start writing our code. We are going to write a simple program here that will teach you the basic blocks.

Motor Power

We went over what power values mean for motors in Step 3. Now, lets find where the blocks are, and tools to help us. 

You can find the blocks by going to Actuators>DcMotor. You will notice that under DcMotor, three options appear: Dual, Quad and Extended. For now, only look at Dual and Quad. Often times, you want to set all the drive motors at once. Rather than getting 4 separate setPower blocks, get one quad and set all the powers in there.

Click on Quad and drag the block that sets all the motor powers to one. Place it under the call program.sleep block. If you run the program now, you will see that nothing happens. This is because the program is terminating immediately as it hits those blocks. To prevent this, add a sleep block. Copy and paste the one from above, and you will see that the power is set for 1000 milliseconds. Change the values in the power block to see how it makes the drivetrain move. You can change the value of the sleep to make it go for longer.(Learn more about sleep here)

Loops

Loops are used to make a bit of code run a certain number of times.

You can find loops in the loops section of the blocks menu.

 

This was a brief intro of critical blocks in VRS. To find out more, check out the resources in the next Step.

VRS Telemetry 

Now that we have seen autonomous, lets take a look at TeleOp. TeleOp is the driver controlled part of the FTC game. Unlike autonomous, TeleOp is pre-programmed. All you have to do is plug in a controller into your computer and play. VRS provides a great way to practice driving. You will need an FTC legal controller to use teleOp. If you don’t have one, skip this step. Let’s take a look.

Enter TeleOp

If you are still in autonomous, click the back button at the top left. Click teleOp in the main menu, and now you will be asked to select singleplayer or multiplayer. Multiplayer creates a lobby for multiple people to play over the internet. For now, lets go into single player. You will see a green play button on the top left. Press it to start the game. As long as your controller is plugged in, VRS should auto detect the controller and immediately take input. For a list of keybinds, see this document. 

All of our content is on the All Lesson page

Here is some selected follow up lessons

For a complete introduction to blocks, visit the intro to blocks article

To learn about how to set motor power, visit the motor power article

All of our content is on the All Lessons page

Here is some selected follow up lessons

TeleOp Beginner guide

STEM Robotics-Lesson from  Portland State  Overview: 

This course is intended to introduce the Java programming language to students using the EV3 (FLL), Tetrix/REV (FTC) and RoboRio (FRC) robotics platforms. For EV3, the course moves the student away from block based robot programming to using a text based programming language. For Tetrix/REV and RoboRio, the course will provide more instruction in Java itself, which is missing in existing materials. The course will teach a basic competency in Java with a focus on robotics applications. Robot construction will not be covered in any depth as it is assumed the student will have or acquire hardware building skills separately. The course is targeted to beginners and there are no prerequisites.

Get started using this course by clicking the first Unit and then the first Lesson. The Lesson content will be displayed and next/previous lesson buttons will appear at the bottom of each lesson making it easy to move between adjacent lessons

VIRTUAL ROBOT SIMULATOR IS A SIMPLE, EASY-TO-USE PLATFORM THAT ALLOWS FTC TEAMS TO PROGRAM AND TEST THEIR ROBOTS WITHOUT ACCESS TO PHYSICAL HARDWARE.